<!DOCTYPE html>
<html lang="en">
<head>
	<meta charset="utf-8">
	<base href="../../../" />
	<script src="page.js"></script>
	<link type="text/css" rel="stylesheet" href="page.css" />
</head>
<body>
	<h1>[name]</h1>

	<h2>Overview</h2>
	<div>
		<p>
			Three.js can use WebGL to render your scenes on all modern browsers. For older browsers, especially Internet Explorer 10 and below, you may have to fallback to one of the other [link:https://github.com/mrdoob/three.js/tree/master/examples/jsm/renderers renderers] (CSS2DRenderer, CSS3DRenderer, SVGRenderer). Additionally, you may have to include some polyfills, especially if you are using files from the [link:https://github.com/mrdoob/three.js/tree/master/examples /examples] folder.
		</p>
		<p>
			Note: if you don't need to support these old browsers, then it is not recommended to use the other renderers as they are slower and support less features than the WebGLRenderer.
		</p>
	</div>

	<h2>Browsers that support WebGL</h2>
	<div>
		<p>
			Google Chrome 9+, Firefox 4+, Opera 15+, Safari 5.1+, Internet Explorer 11 and Microsoft Edge. You can find which browsers support WebGL at [link:https://caniuse.com/#feat=webgl Can I use WebGL].
		</p>
	</div>

	<h2>JavaScript Language Features or Web APIs Used in three.js</h2>
	<div>
		<p>
			Here are some features used in three.js. Some of them may require additional polyfills.
		</p>
		<table>
			<thead>
				<tr>
					<th>Feature</th>
					<th>Use Scope</th>
					<th>Modules</th>
				</tr>
			</thead>
			<tbody>
				<tr>
					<td>Typed Arrays</td>
					<td>Source</td>
					<td>BufferAttribute, BufferGeometry, etc.</td>
				</tr>
				<tr>
					<td>Web Audio API</td>
					<td>Source</td>
					<td>Audio, AudioContext, AudioListener, etc.</td>
				</tr>
				<tr>
					<td>WebXR Device API</td>
					<td>Source</td>
					<td>WebXRManager</td>
				</tr>
				<tr>
					<td>Blob</td>
					<td>Source</td>
					<td>FileLoader, etc.</td>
				</tr>
				<tr>
					<td>Promise</td>
					<td>Examples</td>
					<td>GLTFLoader, DRACOLoader, BasisTextureLoader, GLTFExporter, VRButton, ARButton, etc.</td>
				</tr>
				<tr>
					<td>Fetch</td>
					<td>Examples</td>
					<td>ImageBitmapLoader, etc.</td>
				</tr>
				<tr>
					<td>File API</td>
					<td>Examples</td>
					<td>GLTFExporter, etc.</td>
				</tr>
				<tr>
					<td>URL API</td>
					<td>Examples</td>
					<td>GLTFLoader, etc.</td>
				</tr>
				<tr>
					<td>Pointer Lock API</td>
					<td>Examples</td>
					<td>PointerLockControls</td>
				</tr>
			</tbody>
		</table>
	</div>

	<h2>Polyfills</h2>
	<div>
		<p>Just import polyfills based on your requirements. Taking IE9 as an example, you need to polyfill at least these features:</p>
		<ul>
			<li>Typed Arrays</li>
			<li>Blob</li>
		</ul>
	</div>

	<h3>Suggested polyfills</h3>
	<div>
		<ul>
			<li>
				[link:https://github.com/zloirock/core-js core-js]
			</li>
			<li>
				[link:https://github.com/inexorabletash/polyfill/blob/master/typedarray.js typedarray.js]
			</li>
			<li>
				[link:https://github.com/stefanpenner/es6-promise/ ES6-Promise]
			</li>
			<li>
				[link:https://github.com/eligrey/Blob.js Blob.js]
			</li>
			<li>
				[link:https://github.com/github/fetch fetch]
			</li>
		</ul>
	</div>
</body>
</html>
